home *** CD-ROM | disk | FTP | other *** search
/ Aminet 6 / Aminet 6 - June 1995.iso / Aminet / util / rexx / rkr_rexx.lzh / rkr_rexx.readme < prev    next >
Encoding:
Text File  |  1995-04-11  |  1.7 KB  |  49 lines

  1. Short: A handful of very useful scripts (1.0)
  2. Uploader: Aminet.Upload.Problems@olib.org
  3. Author: rkr@olib.org
  4. Type: util/rexx
  5.  
  6. These six ARexx scripts have proven to be of great use, to me.    They are
  7. primarily to be used as functions from other ARexx scripts:
  8.     COMMAND( CMD )
  9.     Executes a command, CMD, and return the output.  The command output
  10.     is run through a PIPE: stream.    (NOTE: If the program generates no
  11.     output, COMMAND() can get stuck.)
  12.         say compress( command( 'list rexx:command.rexx' ), 'ex' )
  13.         ==>
  14.         Dirctory "r:" on Tusday 11-Apr-95
  15.         command.r              431 ----rwd 29-Jan-95 03:51:58
  16.         1 fil - 2 blocks usd
  17.  
  18.     GETENV( VAR )
  19.     Retrieves a given ENV: VAR for you.
  20.         say getenv( 'user' )                ==> rkr
  21.  
  22.     GETFILE( FILE )
  23.     Reads the contents of a FILE.
  24.         say getfile( 'env:user' )           ==> rkr
  25.  
  26.     PUTFILE( CONTENTS, FILE )
  27.     Stores CONTENTS into a FILE.
  28.         say putfile( 'test', 'ram:test' )   ==> test
  29.  
  30.     REPLACE( SRC, OLD, NEW )
  31.     Scans SRC and changes all OLD with NEW.  The result string is
  32.     returned.
  33.         say replace( 'abc', 'b', 'bb' )     ==> abbc
  34.  
  35.     SETENV( CONTENTS, VAR, ENVARC )
  36.     Stores CONTENTS into the ENV: var, VAR.  If you pass a 1 in for
  37.     ENVARC, it also writes the data to the ENVARC: copy of the VAR.
  38.         say setenv( 'rkr', 'user', 1 )      ==> rkr
  39.  
  40. These 6 recur enough that it seems silly to rewrite them in every script I
  41. write, but not so often/centrally that it's worth taking the time to create
  42. a proper .library for them.
  43.  
  44. I'm posting them seperately as I hope to shortly release a set of archives,
  45. somewhat independant, but all of them hinging, to one degree or another, on
  46. these six scripts for occasional support.  Who knows, you might even find
  47. your OWN uses for them.  (^&
  48.  
  49.